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1. AN OVERVIEW OF CP/M 2.0 FACILITIES. 

CP/t4 2.0 is a nigh-performance single-console operating system 
which uses table driven techniques to allow field reconfiguration to 
match a wide variety of disk capacities. All of the fundamental file 
restrictions are removed, while maintaining upward compatibility from 
previous versions of release 1. Features of CP/M 2.0 include field 
specification of one to sixteen logical drives, each containing up to 
eight megabytes. Any particular file can reach the full drive size 
with the capability to expand to thirty-two megabytes in future 
releases. The directory size can be field configured to contain any 
reasonable number of entries, and each file is optionally tagged with 
read/only and system attributes. Users of CP/M 2.0 are physically 
separated oy user numbers, with facilities for file copy operations 
from one user area to another. Powerful relative-record random access 
functions are present in CP/M 2.0 which provide direct access to any 
of the 65536 records of an eight megabyte file. 

All disk-dependent portions of CP/M 2.0 are placed into a 
BIOS-resident "disk parameter block" which is either hand coded or 
produced automatically using the disk definition macro library 
provided with CP/M 2.0. The end user need only specify the maximum 
number of active disks, the starting and ending sector numbers, the 
data allocation size, the maximum extent of the logical disk, 
directory size information, and reserved track values. The macros use 
this information to generate the appropriate tables and table 
references for use during CP/M 2.0 operation. Deblocking information 
is also provided which aids in assembly or disassembly of sector sizes 
which are multiples of the fundamental 128 byte data unit, and 




File expansion is achieved by providing up to 512 logical file 
extents, where each logical extent contains 16K bytes of data. CP/M 
2.0 is structured, nowever, so that as much as 128K bytes of data is 
addressed by a single physical extent (corresponding to a single 
directory entry) , thus maintaining compatibility with previous 
versions while taking full advantage of directory space. 

Random access facilities are present in CP/M 2.0 which allow 
immediate reference to any record of an eight megabyte file. Using 
CP/M's unique data organization, data blocks are only allocated when 
actually required and movement to a record position requires little 
search time. Sequential file access is upward compatible from earlier 
versions to the full eight megabytes, while random access 
compatibility stops at 512K byte files. Due to CP/M 2.0* s simpler and 
faster random access, application programmers are encouraged to alter 
their programs to take full advantage of the 2.0 facilities. 

Several CP/M 2.0 modules and utilities have improvements which 
correspond to the enhanced file system. STAT and PIP both account for 
file attributes and user areas, while the CCP provides a "login" 
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function to change from one user area to another. The CCP also 
formats directory displays in a more convenient manner and accounts 
for both CRT and hard-copy devices in its enhanced line editing 
functions. 

The sections below point out the individual differences between 
CP/M 1.4 and CP/M 2.0, with the understanding that the reader is 
either familiar with CP/M 1.4, or has access to the 1.4 manuals. 
Additional information dealing with CP/M 2.0 I/O system alteration is 
presented in the Digital Research manual "CP/M 2.0 Alteration Guide." 
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2. USER INTERFACE. 

Console line processing takes CRT-type devices into account with 
three new control characters, shown with an asterisk in the list below 
(the symbol "ctl" below indicates that the control key is 
simultaneously depressed) : 

rub/del removes and echoes last character 

ctl-C reboot when at beginning of line 

ctl-E physical end of line 

ctl-H backspace one cnaracter position* 

ctl-J (line feed) terminates current input* 

ctl-M (carriage return) terminates input 

ctl-R retype current line after new line 

ctl-Q remove current line after new line 

ctl-X backspace to beginning of current line* 

In particular, note that ctl-H produces the proper backspace overwrite 
function (ctl-H can be changed internally to another character, such 
as delete, through a simple single byte change). Further, the line 
editor keeps track of the current prompt column position so that the 
operator can properly align data input following a ctl-U, cti-R, or 
ctl-X command. 



(All Information Contained Herein is Proprietary to Digital Research.) 

3 



3. CONSOLE COMMAND PROCESSOR (CCP) INTERFACE. 

There are four functional differences between CP/M 1.4 and CP/M 
2.0 at the console command processor (CCP) level. The CCP now 
displays directory information across the screen (four elements per 
line) , the USER command is present to allow maintenance of separate 
files in the same directory, and the actions of the "ERA *.**' and 
"SAVE" commands have changed. The altered DIR format is 
self-explanatory, while the USER command takes the form: 

USER n 

where n is an integer value in the range to 15. Upon cold start, 
the operator is automatically "logged" into user area number 0, which 
is compatible with standard CP/M 1.4 directories. The operator may 
issue the USER command at any time to move to another logical area 
within the same directory. Drives which are logged-in while 
addressing one user number are automatically active when the operator 
moves to another user number since a user number is simply a prefix 
which accesses particular directory entries on the active disks. 

The active user number is maintained until changed by a 
subsequent USER command, or until a cold start operation when user 
is again assumed. 

Due to the fact that user numbers now tag individual directory 
entries, the ERA *.* command has a different effect. In version 1.4, 
this command can be used to erase a directory whicn has "garbage" 
information, perhaps resulting from use of a diskette under another 
operating system (heaven forbidl). In 2.0, however, the ERA *.* 
command affects only the current user number. Thus, it is necessary 
to write a simple utility to erase a nonsense disk (the program simply 
writes the hexadecimal pattern E5 throughout the disk). 

The SAVE command in version 1.4 allows only a single memory save 
operation, with the potential of destroying the memory image due to 
directory operations following extent boundary changes. Version 2.0, 
nowever, does not perform directory operations in user data areas 
after disk writes, and thus the SAVE operation can be used any number 
of times without altering the memory image. 
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4. STAT ENHANCEMENTS. 

The STAT program has a number of additional functions which 
allow disk parameter display, user number display, and file indicator 
manipulation. The command: 

STAT VAL: 

produces a summary of the available status commands, resulting in the 
output: 

Temp R/0 Disk: d:=R/0 

Set^ Indicator: d:f ilename. typ $R/0 $R/v^ $SYS $DIR 

Disk Status : DSK: d:DSK: 

aser Status : USR: 

lobyte Assign: 

(list of possible assignments) 

whicn gives an instant summary of the possible STAT commands. The 
command form: 

STAT d:f ilename. typ SS 

wnere '*d:" is an optional drive name, and "filename, typ" is an 

unambiguous or ambiguous file name, produces the output display 
format: 

Size Recs Sytes Ext Ace 

48 48 6k 1 R/0 A:ED.COM 

55 55 12k 1 R/0 (A:PIP.COM) 

65536 128 2k 2 R/vg A:X.DAT 

where tne $S parameter causes the "Size" field to be displayed 
(without the $S, the Size field is skipped, but the remaining fields 
are displayed) . The Size f^eld lists the virtual file size in 
records, while the "Recs" field sums the number of virtual records in 
each extent. For files constructed sequentially, the Size and Recs 
fields are identical. The "Bytes" field lists the actual number of 
bytes allocated to the corresponding file. The minimum allocation 
unit is determined at configuration time, and thus the number of bytes 
corresponds to the record count plus the remaining unused space in the 
last allocated block for sequential files. Random access files are 
given data areas only when written, so the Bytes field contains the 
only accurate allocation figure. In the case of random access, the 
Size field gives the logical end-of-file record position and the Recs 
field counts the logical records of each extent (each of these 
extents, however, may contain unallocated "holes" even though they are 
added into the record count). The "Ext" field counts the number of 
logical 16K extents allocated to the file. Unlike version 1.4, the 
Ext count does not necessarily correspond to the number of directory 
entries given to the file, since there can be up to 128K oytes (8 
logical extents) directly addressed by a single directory entry, 
depending upon allocation size (in a special case, there are actually 
256K bytes which can be directly addressed by a physical extent) . 



The "Ace 
changed using 



field gives the R/0 or R/W access mode, which is 
the commands shown below. Similarly, the parentheses 
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shown around the PIP.COM file name indicate that it has the ''system" 
indicator set^ so that it will not be listed in DIR commands. The 
four command forms 

STAT d:f ilename.typ i?R/0 

STAT d:f ilename.typ $R/W 

STAT d:f ilename.typ $SYS 

STAT d:f ilename.typ $DIR 
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file 
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waits for a console input before performing a subsequent 
"return" is sufficient to continue) . The command form 



STAT d:DSK: 

lists the drive characteristics of the disk named by "d:" which is in 
tne range A:, B:, ..., P:. The drive characteristics are listed in 
the format: 

d: Drive Characteristics 
65536: 128 Byte record Capacity 
8192: Kilobyte Drive Capacity 
128: 32 Byte Directory Entries 
0: Checked Directory Entries 
1024: Records/ Extent 
128: Records/ Block 
58: Sectors/ Track 
2: Reserved Tracks 



where "d:" is the selected 
capacity (65536 is an 8 
capacity listed in Kilobytes, 
followed by the "checked" e 
usually identical to the dire 
this mechanism is used to d 
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or warm start. The number 
addressing capacity of each 



drive, fol 
megabyte dr 
The direc 
ntries. The 
ctory size 
etect change 
tart. For f 
ia is not ch 
of records 
directory en 



lowed by the total record 
ive) , followed by the total 
tory size is listed next, 

number of checked entries is 
for removable media, since 
d media during CP/M operation 
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anged without at least a cold 

per extent determines the 
try (1024 times 128 bytes, or 
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128K in the example above) . The number of records per block shows the 
basic allocation size (in the example, 128 records/block times 128 
bytes per record, or 16K bytes per block). The listing is then 
followed by the number of physical sectors per track and the number of 
reserved tracks. For logical drives which share the same physical 
disk, the number of reserved tracks may be quite large, since this 
mechanism is used to skip lower-numbered disk areas allocated to other 
logical disks. The command form 

STAT DSK: 

produces a drive characteristics table for all currently active 
drives. The final STAT command form is 

STAT USR: 

which produces a list of the user numbers which have files on the 
currently addressed disk. The display format is: 

Active User : 
Active Files: 13 

where the first line lists the currently addressed user number, as set 
by the last CCP USER command, followed by a list of user numbers 
scanned from the current directory. In the above case, the active 
user number is (default at cold start) , with three user numbers 
which have active files on the current disk. The operator can 
subsequently examine the directories of the other user numbers by 
logging-in with USER 1, USER 2, or USER 3 commands, followed by a DIR 
command at the CCP level. 
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5. PIP ENHANCEMENTS. 

PIP provides three new functions which account for the features 
of CP/M 2.0. All three functions take the form of file parameters 
which are enclosed in square brackets following the appropriate file 
names. The commands are: 

Gn Get File from User number n 
(n in the range - 15) 

W Write over R/0 files without 
console interrogation 

R Read system files 

The G command allows one user area to receive data files from another. 
Assuming the operator has issued the USER 4 command at the CCP level, 
the PIP statement 

PIP X.y = X.Y[G2] 

reads file X.Y from user number 2 into user area number 4. The 
command 

PIP A:=A:*.*[G2] 

copies all of the files from the A drive directory for user number 2 
into the A drive directory of the currently logged user number. Note 
that to ensure file security, one cannot copy files into a different 
area than the one which is currently addressed by the USER command. 

Note also that the PIP program itself is initially copied to a 
user area (so that subsequent files can be copied) using the SAVE 
command. The sequence of operations shown below effectively moves PIP 
from one user area to the next. 

USER login user 

DDT PIP.COM load PIP to memory 
(note PIP size s) 
G0 return to CCP 

USER 3 login user 3 

SAVE S PIP.COM 

where s is the integral number of memory "pages" (256 byte segments) 
occupied by PIP. The number s can be determined when PIP.COM is 
loaded under DDT, by referring to the value under the "NEXT" display. 
If for example, the next available address is 1D00, then PIP.COM 
requires IC hexadecimal pages (or 1 times 16+12 = 28 pages) , and 
thus the value of s is 28 in the subsequent save. Once PIP is copied 
in this manner, it can then be copied to another disk belonging to the 
same user number through normal pip transfers. 

Under normal operation, PIP will not overwrite a file which is 
set to a permanent R/0 status. If attempt is made to overwrite a R/0 
file, the promot 
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nPSTINATION FILE IS R/0, DELETE (Y/N)? 

is issued. If the operator responds with the character "y" then the 
file is overwritten. Otherwise, the response 

** NOT DELETED ** 

is issued, the file transfer is skippped, and PIP continues with the 
next operation in sequence. In order to avoid the prompt and response 
in the case of R/0 file overwrite, the command line can include the W 
parameter, as shown below 

PIP A:=B:*.COM[W] 

which copies all non-system files to. the A drive from the B drive, and 
overwrites any R/0 files in the process. If the operation involves 
several concatenated files, the W parameter need only be included with 
the last file in the list, as shown in the following example 

PIP A. DAT = B.DAT,F:NEW.DAT,G:OLD.DAT[W] 

Files with the system attribute can be included in PIP transfers 
if the R parameter is included, otherwise system files are not 
recognized. The command line 

PIP ED.COM = B:ED.COM[R] 

for example, reads the ED.COM file from the B drive, even if it has 
been marked as a R/0 and system file. The system file attributes are 
copied, if present. 



It should be noted that downward compatibility with previous 
versions of CP/M is only maintained if the file does not exceed one 
megabyte, no file attributes are set, and the file is created by user 
0. If compatibility is required with non-standard (e.g., "double 
density") versions of 1.4, it may be necessary to select 1.4 
compatibility mode when constructing the internal disk parameter block 
(see the "CP/M 2.0 Alteration Guide," and refer to Section 10 which 
describes BIOS differences). 



(All Information Contained Herein is Proprietary to Digital Research.) 

9 



6. ED ENHANCEMENTS. 

The CP/M standard program editor provides several new facilities 
in the 2.0 release. Experience has shown that most operators use the 
relative line numbering feature of ED, and thus the editor has the "v" 
(Verify Line) option set as an initial value. The operator can, of 
course, disable line numbering by typing the '"-v" command. If you are 
not familiar with the ED line number mode, you may wish to refer to 
the Appendix in the ED user's guide, where the "v" command is 
described. 

ED also takes file attributes into account. If the operator 
attempts to edit a read/only file, the message 

** FILE IS READ/ONLy ** 

appears at the console. The file can be loaded and examined, but 
cannot be altered in any way. Normally, the operator simply ends the 
edit session, and uses STAT to change the file attribute to R/W. If 
the edited file has the "system" attribute set, the message 

"SYSTEM" FILE NOT ACCESSIBLE 

is displayed at the console, and the edit session is aborted. Again, 
the STAT program can be used to change the system attribute, if 
desired. 

Finally, the insert mode ("i**) command allows CRT line editing 
functions, as described in Section 2, above. 
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7. THE XSUB FUNCTION. 

An additional utility program is supplied with version 2.0 of 
CP/M, called XSUB, which extends the power of the SUBMIT facility to 
include line input to programs as well as the console command 
processor. The XSUB command is included as the first line of your 
submit file and, when executed, self-relocates directly below the CCP. 
All subsequent submit command lines are processed by XSUB, so that 
programs which read buffered console input (BDOS function 10) receive 
their input directly from the submit file. For example, the file 
SAVER. SUB could contain the submit lines: 

XSUB 

DDT 

I$1.HEX 

R 

G0 

SAVE 1 $2. COM 

with a subsequent SUBMIT command: 

SUBMIT SAVER X Y 

which substitutes X for $1 and Y for $2 in the command stream. The 
XSUB program loads, followed by DDT which is sent the command lines 
"IX. HEX" "R" and "G0" thus returning to the CCP. The final command 
"SAVE 1 Y.COM" is processed by the CCP. 

The XSUB program remains in memory, and prints the message 

(xsub active) 

on each warm start operation to indicate its presence. Subsequent 
submit command streams do not require the XSUB, unless an intervening 
cold start has occurred. Note that XSUB must be loaded after DESPOOL, 
if both are to run simultaneously. 
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BDOS INTERFACE CONVENTIONS 



CP/M 2.0 system calls take place in exactly the same manner as 
earlier versions, with a call to location 0005H, function number in 
register C, and information address in register pair DE, Single byte 
values are returned in register A, with double byte values returned in 
HL {for reasons of compatibility, register A = L and register B = H 
upon return in all cases). A list of CP/M 2.0 calls is 
with an asterisk following functions which are either 
from version 1.4 to 2.0. Note that a zero value is 
out-of range function numbers. 



given below, 
new or revised 
returned for 





1 

2 

3 

4 

5 

6* 

7 

8 

9 
10* 
11 
12* 
13 
14 
15* 
16 
17* 
18* 



System Reset 

Console Input 

Console Output 

Reader Input 

Punch Output 

List Output 

Direct Console I/O 

Get I/O Byte 

Set I/O Byte 

Print String 

Read Console Buffer 

Get Console Status 

Return Version Number 

Reset Disk System 

Select Disk 

Open File 

Close File 

Search for First 

Search for Next 



19* 

20 

21 

22* 

23* 

24* 

25 

26 

27 

28* 

29* 

30* 

31* 

32* 

33* 

34* 

35* 

36* 



Delete File 
Read Sequential 
Write Sequential 
Make File 
Rename File 
Return Login Vector 
Return Current Disk 
Set DMA Address 
Get Addr (Alloc) 
Write Protect Disk 
Get Addr(R/0 Vector) 
Set File Attributes 
Get Addr(Disk Parms) 
Set/Get User Code 
Read Random 
Write Random 
Comoute File Size 
Set Random Record 



(Functions 26, 29, and 32 should be avoided in application programs to 
maintain upward compatibility with MP/M.) The new or revised functions 
are described below. 



Function 6: Direct Console I/O. 

Direct Console I/O is supported under CP/M 2.0 for those 
applications where it is necessary to avoid the BDOS console I/O 
operations. Programs whicn currently perform direct I/O through the 
BIOS should be changed to use direct I/O under BDOS so that they can 
be fully supported under future releases of MP/M and CP/M. 

Upon entry to function 6, register E eitner contains hexadecimal 
FF, denoting a console input request, or register E contains an ASCII 
character. If the input value is FF, then function 6 returns A = 00 
if no character is ready, otherwise A contains the next console input 
character. 

If the input value in E is not FF, then function 6 assumes that 
E contains a valid ASCII character which is sent to the console. 



(All Information Contained Herein is Proprietary to Digital Research.) 

12 



Function 10: Read Console Buffer. 

The console buffer read operation remains unchanged except that 
console line editing is supported, as described in Section 2. Note 
also that certain functions which return the carriage to the leftmost 
position (e.g., ctl-X) do so only to the column position where the 
prompt ended (previously, the carriage returned to the extreme left 
margin) . This new convention makes operator data input and line 
correction more legible. 



E'unction 12: Return Version Number. 

Function 12 has been redefined to provide information which 
allows version-independent programming (this was previously the "lift 
head" function which returned HL=0000 in version 1.4, but performed no 
operation) . The value returned by function 12 is a two-byte value, 
with H = 00 for the CP/M release (H = 01 for MP/M) , and L = 00 for all 
releases previous to 2.0. CP/M 2.0 returns a hexadecimal 20 in 
register L, with subsequent version 2 releases in the hexadecimal 
range 21, 22, through 2F. Using function 12, for example, you can 
write application programs which provide both sequential and random 
access functions, with random access disabled when operating under 
early releases of CP/M. 

In the file operations described below, DE addresses a file 
control block (FCBJ . Further, all directory operations take place in 
a reserved area which does not affect write buffers as was the case in 
version 1.4, with the exception of Search First and Search Next, where 
compatibility is required. 

The File Control Block (FCB) data area consists of a sequence of 33 
bytes for sequential access, and a series of 36 bytes in the case that 
the file is accessed randomly. The default file control block 
normally located at 005CH can be used for random access files, since 
bytes 007DH, 007EH, and 007FH are available for this purpose. For 
notational purposes, the FC3 format is shown with the following 
fields : 
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|dr|fl|f2|/ /|f8| tl|t2|t3|ex|sl|s2|rc|d0|/ / | dn I cr I r0 I rl I r2 t 
00 01 02 ... 08 09 10 11 12 13 14 15 16 ... 31 32 33 34 35 



where 



dr drive code (0 - 16) 

=> use default drive for file 

1 => auto disk select drive A, 

2 => auto disk select drive B, 
• • • 

16=> auto disk select drive P. 

fl...f8 contain the file name in ASCII 
upper case, with high bit = 

tl,t2,t3 contain the file type in ASCII 
upper case, with high bit = 
tl', t2', and t3' denote the 
bit of these oositions, 
tl' = 1 => Read/Only file, 
t2' = 1 => SYS file, no DIR list 

ex contains the current extent number, 
normally set to 00 by the user, but 
in range 0-31 during file I/O 

si reserved for internal system use 

s2 reserved for internal system use, set 
to zero on call to OPEN, MAKE, SEARCH 

re record count for extent "ex," 
takes on values from - 128 

d0...dn filled-in by CP/M, reserved for 
system use 

cr current record to read or write in 

a sequential file operation, normally 
set to zero by user 

r0,rl,r2 optional random record number in the 
range 0-65535, with overflow to r2, 
r0,rl constitute a 16-bit value with 
low byte r0 , and high byte rl 



Function 15: Open File. 

The Open File operation is identical to previous definitions, 
with the exception that byte s2 is automatically zeroed. Note that 
previous versions of CP/M defined this byte as zero, but made no 
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checks to assure compliance. Thus, the byte is cleared to ensure 
upward compatibility with the latest version, where it is required. 



Function 17: Search for First. 

Search First scans the directory for a match with the file given 
by the FCB addressed by DE. The value 255 (hexadecimal FF) is 
returned if the file is not found, otherwise a value of A equal to 0, 
1, 2, or 3 is returned indicating the file is present. In the case 
that the file is found, the current DMA address is filled with the 
record containing the directory entry, and the relative starting 
position is A * 32 (i.e., rotate the A register left 5 bits, or ADD A 
five times). Although not normally required for application programs, 
the directory information can be extracted from the buffer at this 
position. 

An ASCII question mark (63 decimal, 3F hexadecimal) in any 
position from fl through ex matches the corresponding field of any 
directory entry on the default or auto-selected disk drive. If the dr 
field contains an ASCII question mark, then the auto disk select 
function is disabled, the default disk is searched, with the search 
function returning any matched entry, allocated or free, belonging to 
any user number. This latter function is not normally used by 
application programs, out does allow complete flexibility to scan all 
current directory values. If the dr field is not a question mark, the 
s2 byte is automatically zeroed. 



Function 18: Search for Next. 



The Search Next function is similar to the Search First 
function, except that the directory scan continues from the last 
matched entry. Similar to function 17, function 18 returns the 
decimal value 255 in A when no more directory items match. 



Function 19: Delete File. 

The Delete File function removes files which match the FCB 
addressed by DE. The filename and type may contain ambiguous 
references (i.e., question marks in various positions), but the drive 
select code cannot be ambiguous, as in the Search and Search Next 
functions. 

Function 19 returns a decimal 255 if the reference file or files 
could not be found, otherwise a value in the range to 3 is returned. 
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Function 22: Make File. 

The Make File operation is identical to previous versions of 
CP/M, except that byte s2 is zeroed upon entry to the BDOS. 



Function 23: Rename File. 

The Actions of the file rename functions are the same as 
previous releases except that the value 255 is returned if the rename 
function is unsuccessful (the file to rename could not be found) , 
otherwise a value in the range to 3 is returned. 



Function 24: Return Login Vector. 

The login vector value returned by CP/M 2.0 is a 16-bit value in 
HL, where the least significant bit of L corresponds to the first 
drive A, and the high order bit of H corresponds to the sixteenth 
drive, labelled P. Note that compatibility is maintained with earlier 
releases, since registers A and L contain the same values upon return. 



Function 28: Write Protect Current Disk. 

The disk write protect function provides temporary write 

protection for the currently selected disk. Any attempt to write to 

the disk, before the next cold or warm start operation produces the 
message 

Bdos Err on d: R/0 



Function 29: Get R/0 Vector. 

Function 29 returns a bit vector in register pair HL which 
indicates drives which have the temporary read/only bit set. Similar 
to function 24, the least significant oit corresponds to drive A, 
while the most significant bit corresponds to drive P. The R/0 bit is 
set either by an explicit call to function 28, or by the automatic 
software mechanisms within CP/M which detect changed disks. 



Function 30: Set File Attributes. 

The Set File Attributes function allows programmatic 
manipulation of permanent indicators attached to files. In 
particular, the R/0 and System attributes (tl* and t2' above) can be 
set or reset. The DE pair addresses an unambiguous file name with the 
appropriate attributes set or reset. Function 30 searches for a 
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match, and changes the matched directory entry to contain the selected 
indicators. Indicators fl' through f4* are not presently used, but 
may be useful for applications programs, since they are not involved 
in the matching process during file open and close operations. 
Indicators f5' through f8* and t3* are reserved for future system 
exoansion. 



Function 31: Get Disk Parameter Block Address. 

The address of the BIOS resident disk parameter block is 
returned in HL as a result of this function call. This address can be 
used for either of two purposes. First, the disk parameter values can 
be extracted for display and space computation purposes, or transient 
programs can dynamically change the values of current disk parameters 
when the disk environment changes, if required. Normally, application 
programs will not require this facility. 



Function 32: Set or Get User Code. 

An application program can change or interrogate the currently 
active user number by calling function 32. If register E = FF 
nexaciecimal , then the value of the current user number is returned in 
register A, where the value is in the range to 31. If register E is 
not FF, then the current user number is changed to the value of E 
(modulo 32) . 



Function 33: Read Random. 

The Read Random function is similar to the sequential file read 
operation of previous releases, except that the read operation takes 
place at a particular record number, selected by the 24-bit value 
constructed from the three byte field following the FCB (byte 
positions r0 at 33, rl at 34, and r2 at 35). Note that the sequence 
of 24 bits is stored with least significant byte first (r0) , middle 
byte next (rl), and high byte last (r2) , CP/M release 2.0 does not 
reference byte r2, except in computing the size of a file (function 
35) . Byte r2 must be zero, however, since a non-zero value indicates 
overflow past the end of file. 

Thus, in version 2.0, the r0,rl byte pair is treated as a 
double-byte, or "word" value, which contains the record to read. This 
value ranges from to 65535, providing access to any particular 
record of the 8 megabyte file. In order to process a file using 
random access, the base extent (extent 0) must first be opened. 
Although the base extent may or may not contain any allocated data, 
this ensures that the file is properly recorded in the directory, and 
is visible in DIR requests. The selected record number is then stored 
into the random record field (r0,rl), and the BDOS is called to read 
the record. Upon return from the call, register A either contains an 
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error code, as listed below, or the value 00 indicating the operation 
was successful. In the latter case, the current DMA address contains 
the randomly accessed record. Note that contrary to the sequential 
read operation, the record number is not advanced. Thus, subsequent 
random read operations continue to read the same record. 

Upon each random read operation, the logical extent and current 
record values are automatically set. Thus, the file can be 
sequentially read or written, starting from the current randomly 
accessed position. Note, however, that in this case, the last 
randomly read record will be re-read as you switch from random mode to 
sequential read, and the last record will be re-written as you switch 
to a sequential write operation. You can, of course, simply advance 
the random record position following each random read or write to 
obtain the effect of a sequential I/O operation. 

Error codes returned in register A following a random read are 
listed below. 

01 reading unwritten data 

02 (not returned in random mode) 

03 cannot close current extent 

04 seek to unwritten extent 

05 (not returned in read mode) 

06 seek past physical end of disk 

Error code 01 and 04 occur when a random read operation accesses a 
data block which has not been previously written, or an extent which 
has not been created, which are equivalent conditions. Error 3 does 
not normally occur under proper system operation, but can be cleared 
by simply re-reading, or re-opening extent zero as long as the disk is 
not physically write protected. Error code 06 occurs whenever byte r2 
is non-zero under the current 2.0 release. Normally, non-zero return 
codes can be treated as missing data, with zero return codes 
indicating operation complete. 



Function 34: Write Random. 

The Write Random operation is initiated similar to the Read 
Random call, except that data is written to the disk from the current 
DMA address. Further, if the disk extent or data block which is the 
target of the write has not yet been allocated, the allocation is 
performed before the write operation continues. As in the Read Random 
operation, the random record number is not changed as a result of the 
write. The logical extent number and current record positions of the 
file control block are set to correspond to the random record which is 
being written. Again, sequential read or write operations can 
commence following a random write, with the notation that the 
currently addressed record is either read or rewritten again as the 
sequential operation begins. You can also simply advance the random 
record position following each write to get the effect of a sequential 
write operation. Note that in particular, reading or writing the last 
record of an extent in random mode does not cause an automatic extent 
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switch as it does in sequential mode under either CP/M 1.4 or CP/M 
2.0. 

The error codes returned by a random write are identical to the 
random read operation with the addition of error code 05, which 
indicates that a new extent cannot be created due to directory 
overflow. 



Function 35: Compute File Size. 

When computing the size of a file, the DE register pair 
addresses an FCB in random mode format (bytes r0, rl, and r2 are 
present). The FCB contains an unambiguous file name which is used in 
the directory scan. Upon return, the random record bytes contain the 
"virtual" file size which is, in effect, the record address of the 
record following the end of the file. if, following a call to 
function 35, the high record byte r2 is 01, then the file contains the 
maximum record count 65536 in version 2.0. Otherwise, bytes r0 and rl 
constitute a 16-bit value (r0 is the least significant byte, as 
before) which is the file size. 

Data can be appended to the end of an existing file by simply 
calling function 35 to set the random record position to the end of 
file, then performing a sequence of random writes starting at the 
preset record address. 

The virtual size of a file corresponds to the physical size when 
the file is written sequentially. If, instead, the file was created 
in random mode and "holes'* exist in the allocation, then the file may 
in fact contain fewer records than the size indicates. If, for 
example, only the last record of an eight megabyte file is written in 
random mode (i.e. , record number 65535) , then the virtual size is 
65536 records, although only one block of data is actually allocated. 



Function 36: Set Random Record. 

The Set Random Record function causes the BDOS to automatically 
produce the random record position from a file which has been read or 
written sequentially to a particular point. The function can be 
useful in two ways. 
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involved since the program need only store the buffer-relative byte 
position along with the key and record number in order to find the 
exact starting position of the keyed data at a later time. 

A second use of function 36 occurs when switching from a 
sequential read or write over to random read or write. A file is 
sequentially accessed to a particular point in the file, function 36 
is called which sets the record number, and subsequent random read and 
write operations continue from the selected point in the file. 



This section is concluded with a rather extensive, but complete 
example of random access operation. The program listed below performs 
the simple function of reading or writing random records upon command 
from the terminal. Given that the program has been created, 
assembled, and placed into a file labelled RAl^DOM.COM, the CCP level 
command: 

RANDOM X.DAT 

starts the test program. The program looks for a file by the name 
X.DAT (in this particular case) and, if found, proceeds to prompt the 
console for input. If not found, the file is created before the 
prompt is given. Each prompt takes the form 

next command? 

and is followed by operator input, terminated by a carriage return. 
The input commands take the form 

nW nR Q 

where n is an integer value in the range to 65535, and W, R, and Q 
are simple command characters corresponding to random write, random 
read, and quit processing, respectively. If the W command is issued, 
the RANDOM program issues the prompt 

type data: 

The operator then responds by typing up to 127 characters, followed by 
a carriage return. RANDOM then writes the character string into the 
X.DAT file at record n. If the R command is issued, RANDOM reads 
record number n and displays the string value at the console. If the 
Q command is issued, the X.DAT file is closed, and the program returns 
to the console command processor. In the interest of brevity (ok, so 
the program's not so brief), the only error message is 

error, try again 

The program begins with an initialization section where the 
input file is opened or created, followed by a continuous loop at the 
label "ready" where the individual commands are interpreted. The 
default file control block at 005CH and the default buffer at 0080H 
are used in all disk operations. The utility subroutines then follow, 
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which contain the principal input line processor, called "readc," 

This particular program shows the elements of random access 

processing, and can be used as the basis for further program 
development. 



0100 

0000 
0005 

0001 
0002 
0009 
000a 
000c 
000f 
0010 
0016 

0021 

0022 

005c 
007d 
7f 
0080 

000d 
000a 



0100 31bc0 



0103 0e0c 
0105 cd050 
0108 fe20 
010a d2160 

010d lllb0 
0110 cdda0 
0113 C3000 



***************************** 

* 

program for cp/m 2.0 * 

* 

***************************** 
;base of tpa 



? system reboot 
;bdos entry point 

console input function 
console output function 
print string until '$* 
read console buffer 
return version number 
file open function 
close function 
make file function 
read random 
write random 

;default file control block 
;random record position 
;high order (overflow) byte 
;buffer address 

;carriage return 
;line feed 



*************************************************** 

* * 

* load SP, set-up file for random access * 

* * 
*************************************************** 

Ixi sp, stack 

version 2.0? 

mvi c, version 

call bdos 

cpi 20h ;version 2.0 or better? 

jnc versok 

bad version, message and go back 

Ixi d,badver 

call print 

jmp reboot 



versok: 

; correct version for random access 



• ********************** 

. * 


• ** 

;* sample ra 
• * 


ndom access 


.********************** 




org 


100h 


reboot 


equ 


0000h 


bdos 

• 


equ 


0005h 


1 
coninp 


equ 


1 


conout 


equ 


2 


pstring 


equ 


9 


rstring 


equ 


10 


version 


equ 


12 


openf 


equ 


15 


closef 


equ 


16 


makef 


equ 


22 


readr 


equ 


33 


writer 


equ 


34 


fcb 


equ 


005ch 


ranrec 


equ 


fcb+3 3 


ranovf 


ec[u 


fcb+35 


buff 


equ 


0080h 


7 

cr 


equ 


0dh 


If 


equ 


0ah 
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0116 


0e0f 


0118 


115C0 


011b 


cd050 


011e 


3c 


011f 


C2370 

• 


0122 


• 

0el6 


0124 


115C0 


0127 


C(3050 


012a 


3c 


012b 


C2370 

• 
/ 


012e 


• 

113a0 


0131 


cdda0 


0134 


C3000 



0156 fe57 
0158 C2890 



015b 114d0 
015e cdda0 



mvi c,openf ;open default fcb 

Ixi d,fcb 

call bdos 

inr a ;err 255 becomes zero 

jnz ready 

cannot open file, so create it 

mvi cmakef 

Ixi d,fcb 

call bdos 

inr a ;err 255 becomes zero 

jnz ready 

cannot create file, directory full 

Ixi d,nospace 

call print 

jmp reboot ;back to ccp 

*************************************************** 

* loop back to "ready" after each command * 

* * 
*************************************************** 



0137 


cde50 


013a 


227d0 


013d 


217f0 


0140 


3600 


0142 


feSl 


0144 


C2560 

• 
t 


0147 


9 

0el0 


0149 


115C0 


014c 


cd050 


014f 


3c 


0150 


cab90 


0153 


C3000 



ready: 

file is ready for processing 

call readcom ;read next command 

stild ranrec ;store input record# 

Ixi h,ranovf 

mvi m,0 ;clear high byte if set 

cpi 'Q* ;quit? 

jnz notq 

quit processing, close file 

mvi c,closef 

Ixi d,fcb 

call bdos 

inr a ;err 255 becomes 

jz error ;error message, retry 

jmp reboot ;back to ccp 

• * -k 

t 

;* end of quit command, process write * 

• iiiiiiiiiiiiiiicizi^iiifiiiiiiiii^ii'kiiiii^-kii'kii-k-k-k-k-kiiii-k-k'k'k-k'k'kiiii-k-k-k-k-k-k'k'kii 

9 

notq: 

; not the quit command, random write? 

cpi 'W 

jnz notw 

; this is a random write, fill buffer until cr 
Ixi d,datmsg 
call print ;data prompt 
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0161 

0163 

0166 
0167 
0168 
016D 
016c 
016d 
016f 

0172 
0173 
0174 
0175 



0e7f 
21800 

c5 
e5 

cdc20 
el 

cl 

fe0d 

ca780 

77 
23 
0d 
C2660 



rloop 



erloop 



mvi 

1x1 

? read 

pusn 

push 

call 

pop 

pop 
cpi 

not 
mov 
inx 
dcr 
jnz 



n 



end 



c,127 

h.buff 
ext cha 

b 

h 

getchr 

h 

b 

cr 

erloop 
, store 

m,a 

h 

c 

rloop 



;up to 127 characters 
;destination 
racter to buff 
;save counter 
;next destination 
;character to a 
; restore counter 
;restore next to fill 
;end of line? 

character 

;next to fill 

; counter goes down 

;end of buffer? 



0178 3600 



end of read loop, store 00 
mvi Tn,0 



017a 
017c 
017f 
0182 
0183 
0186 



0e22 

115C0 

cd050 

b7 

c2b90 

C3370 



write the record to selected record number 

mvi c, writer 

Ixi d,fcb 

call bdos 

ora a ;error code zero? 

jnz error ;message if not 

jmp ready ;for another record 



i('ffiti(icitici(icicicititici(i(i(i(ititificicic*i(ititi(ic'kiciti(ifi<itititififici«ititicici(iticic 
it * 

* 



;* end of write command^ orocess read 
- * 



.************************************•************** 



notw 



0189 


fe52 


cpi 


018b 


c2b90 


jnz 




• 
f 


read 


018e 


0e21 


mvi 


0190 


115C0 


Ixi 


0193 


cd050 


call 


0196 


b7 


ora 


0197 


c2b90 


jnz 




• 


read 


019a 


cdcf0 


call 


019d 


0e80 


mvi 


019f 


21800 

wloop: 


Ixi 


01a2 


7e 


mov 


01a3 


23 


inx 


01a4 


e67f 


ani 


01a6 


ca370 


jz 


01a9 


c5 


push 


01aa 


e5 


push 



not a write command, read record? 

error ;skip if not 

read random record 
creadr 
d,fcb 
bdos 

a ;return code 00? 
error 



read was successful, write to console 

crlf ;new line 

c,128 ;max 128 characters 

h,buff ;next to get 

a,m ;next character 

h ;next to get 

7fh ;ma5ik parity 

ready ;for another command if 00 

b ;save counter 

h ;save next to get 
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01ab fe20 


cpi 




;graphic? 


01ad d4c80 


cnc 


putchr 


;skip output if not 


01b0 el 


pop 


h 




01bl cl 


pop 


b 




01b2 0d 


dcr 


c 


;count=count-l 


01b3 c2a20 


jnz 


wloop 




01b6 C3370 


jmp 


ready 





**itic*icicicicicic*icicicic'ki(-ki(-ki(ici(itititi(ifi(i(-ki(i(itici(*icieicitit*itit*i(*ici( 

* end of read command, all errors end-UD here * 

icicitititi(i(i(i<-k*i(-kieicici(iicitititicit-ki<1tici(*iti('k-ki(ici(*icic-kiticititiciti(-kit-kic 







error: 






01b9 


11590 




Ixi 


d,errmsg 


01bc 


cdda0 




call 


print 


01bf 


C3370 




jmp 


ready 



* utility subroutines for console i/o 
* 



01c2 0e01 
01c4 cd050 
01c7 c9 



**************f*********************** ****** ******** 
* * 

* 
* 
*************************************************** 

getchr : 

;read next console character to a 
mvi c,coninp 
call bdos 
ret 



putchr 



01c8 0e02 
01ca 5f 
01cb cd050 
01ce c9 



;write character from a to console 

mvi c,conout 

mov e,a ;character to send 

call bdos ;send character 

ret 



crlf : 



01cf 3e0d 

01dl cdc80 

01d4 3e0a 

01d6 cdc80 

01d9 c9 



;send carriage return line feed 

mvi a,cr ;carriage return 

call putchr 

mvi a, If ;line feed 

call putchr 

ret 



print 



01da d5 
01db cdcf0 
01de dl 
01df 0e09 
01el cd050 
01e4 c9 



;print the buffer addressed by de until $ 

push d 

call crlf 

pop d ;new line 

mvi c^pstring 

call bdos ;print the string 

ret 



readcom: 
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01e5 
01e8 
01eb 
01ed 
01f0 

01f3 
01f6 
01f9 
01fa 
01fb 
01fc 

01fd 
01ff 
0201 

0204 
0205 
0206 
0207 
0208 
0209 
020a 
02tfo 
020c 
020f 
0210 



0213 
0215 
0217 

0218 
021a 



116b0 

cdda0 

0e0a 

117a0 

cd050 

21000 

117C0 

la 

13 

b7 

c8 

d630 
fe0a 
d2130 

29 

4d 

44 

29 

29 

09 

85 

bt 

d2f90 

24 

c3f90 



c630 
fe61 
d8 

e65f 
c9 



readc: Idax 
inx 



endrd: 

r 



;read the next command line to the conbuf 

Ixi d, prompt 

call print ; command? 

mvi crstring 

Ixi d, conbuf 

call bdos ;read command line 

command line is present, scan it 

Ixi h,0 ;start with 0000 

Ixi d,conlin;command line 

d ;next command character 
d ; to next command position 
ora a ; cannot be end of command 
rz 

not zero, numeric? 
sui •0' 

cpi 10 ;carrY if numeric 
jnc endrd 
add-in next digit 
dad h ;*2 
c,l 

;bc = value * 2 

;*4 

;*8 

;*2 + *8 = *10 

;+digit 



mov 
mov 
dad 
dad 
dad 
add 
mov 
jnc 
inr 
jmp 



h 

h 

b 

1 

Ira 

readc 

h 

readc 



;for another char 

joverf low 

;for another char 



021b 
023a 
024d 
0259 
026b 



end of read, restore value in a 

adi '0* ; command 

cpi 'a' ;translate case? 

re 

lower case, mask lower case bits 

ani 101$llllb 

ret 

************************************************ 

* string data area for console messages * 

* * 

*************************************************** 
badver : 

'sorry, you need cp/ra version 2$ * 



536f79 db 

nospace: 
4e6f29 db 

datmsg : 
547970 db 

errmsg: 
457272 db 

prompt: 
4e6570 db 



'no directory space$' 
• type data: $ ' 
'error, try again. $' 
•next command? $' 
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027a 


21 


conbuf : 


db 


027b 




consiz: 


ds 


027c 




conlin: 


ds 


0021 


= 


conlen 


equ 


029c 




stack: 


ds 


02bc 






end 



*************************************************** 

* * 

* fixed and variable data area * 

* * 

*************************************************** 

conlen ; length of console buffer 
1 ;resulting size after read 
32 ;length 32 buffer 
$-consiz 



32 



;16 level stack 
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9. CP/M 2.0 MEMORY ORGANIZATION. 

Similar to earlier versions, CP/M 2.0 is field-altered 
various memory sizes, depending upon the host computer 
configuration. Typical base addresses for popular memory 
shown in the table below. 



to fit 

memory 

sizes are 



Module 

CCP 

BDOS 

BIOS 

Top of Ram 



20k 

3400H 
3C00H 
4A00H 
4FFFH 



24k 

4400H 
4C00H 
5A00H 
5FFFH 



32k 

6400H 
6C00H 
7A00H 
7FFFri 



48k 
A400H 
AC00H 
BA0 0H 
BFFFH 



64k 
E400H 
EC00H 
FA0 0H 
FFFFH 



The distribution disk contains a CP/M 2.0 system configured for a 20k 
Intel MDS-800 with standard IBM 8" floppy disk drives. The disk 
layout is shown below: 



Sector 


Track 


00 


Module 


Track 


01 


Module 


1 


(Bootstrap Loader) 


4080H 


BDOS 


+ 


480H 


2 


3400H 


CCP 


+ 


000H 


4100H 


BDOS 


+ 


500H 


3 


3480H 


CCP 


+ 


080H 


4180H 


BDOS 


+ 


580H 


4 


3500H 


CCP 


+ 


100H 


4200H 


BDOS 


+ 


600H 


5 


3580H 


CCP 


+ 


180H 


4280H 


BDOS 


+ 


680H 


6 


3600H 


CCP 


+ 


200H 


4300H 


BDOS 


+ 


700H 


7 


3680H 


CCP 


+ 


280H 


4 3 80H 


BDOS 


+ 


780H 


d 


3700H 


CCP 


+ 


300H 


4400H 


BDOS 


+ 


800H 


9 


3780H 


CCP 


+ 


380H 


4480H 


BDOS 


+ 


880H 


10 


3800H 


CCP 


+ 


400H 


4500H 


BDOS 


+ 


900H 


11 


3880H 


CCP 


+ 


480H 


4580H 


BDOS 


+ 


980H 


12 


3900H 


CCP 


+ 


500H 


4600H 


BDOS 


+ 


A00H 


13 


3980H 


CCP 


+ 


580H 


4680H 


BDOS 


+ 


A80H 


14 


3A00H 


CCP 


+ 


600H 


4700H 


BDOS 


+ 


B00H 


15 


3A80H 


CCP 


+ 


680H 


4780H 


BDOS 


+ 


B80H 


16 


3B00H 


CCP 


+ 


700H 


4800H 


BDOS 


+ 


C00H 


17 


3B80H 


CCP 


+ 


780H 


4880H 


BDOS 


+ 


C80H 


18 


3C00H 


BDOS 


+ 


000H 


4900H 


BDOS 


+ 


D00H 


19 


3C80H 


BDOS 


+ 


080H 


4980H 


BDOS 


+ 


D80H 


20 


3D00H 


BDOS 


+ 


100H 


4A00H 


BIOS 


+ 


000H 


21 


3D80H 


BDOS 


+ 


180H 


4A80H 


BIOS 


+ 


080H 


22 


3E00H 


BDOS 


+ 


200H 


4B00H 


BIOS 


+ 


100H 


23 


3E80H 


BDOS 


+ 


280H 


4B80H 


BIOS 


+ 


180H 


24 


3F00H 


BDOS 


+ 


300H 


4C00H 


BIOS 


+ 


200H 


25 


3F80H 


BDOS 


+ 


380H 


4C80H 


BIOS 


+ 


280H 


26 


4000H 


BDOS 


+ 


400H 


4D00H 


BIOS 


+ 


300H 



In particular, note that the CCP is 

and occupies the same space as 

however, occupies one more 256-byte 

through the remainder of track 

decimal) bytes in length, the BDOS 

length, and the BIOS is up to 380H 

version 2.0, the BIOS portion contains the standard 

1.4, along with some initialized table space, as 

following section. 



at the same position on the disk, 

version 1.4. The BDOS portion, 

page and the BIOS portion extends 

01. Thus, the CCP is 800H (2048 



is E00H (3584 
(898 decimal) 



decimal) bytes in 

bytes in length. In 

subroutines of 

described in the 
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10. BIOS DIFFERENCES. 

The CP/M 2.0 Basic I/O System differs only slightly in concept 
from its predecesssors. Two new jump vector entry points are defined, 
a new sector translation subroutine is included, and a disk 
characteristics table must be defined. The skeletal form of these 
changes are found in the program shown below. 



1 
2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 



bpb 
rpb 
maxb 



boot: 
lists 



t: 



seldsk: 



selsec 



org 
maclib 

jmp 



4000h 

diskdef 

boot 



jmp listst ;list status 

jmp sectran ;sector translate 

disks 4 

large capacity drive 



equ 

equ 

equ 

diskdef 

diskdef 

diskdef 

diskdef 

ret 

xra 

ret 



;bytes per block 
; records per block 



16*1024 

bpb/128 

65535/rpb ;max block number 

0,1,58,3, bpb ,maxb+l,128,0,2 

1,1,58, ,bpb,maxb+l ,128,0,2 

2,0 

3,1 



;nop 



;nop 



;dr ive 

Ixi 

mov 

cpi 

rnc 

proper 

mov 

dad 

dad 

dad 

dad 

Ixi 

dad 

ret 



number 
h,0 
a 



in 



ndisks 



disk 
l.c 

h 

h 

h 

h 

d ,dpbase 

d 



c 

0000 in hi produces 

a is disk number .. 

. less than ndisks? 

;return with HL = 0000 
number, return dpb element 



select error 
. . ndisks-1 

if not 
address 



*2 
*4 
*8 
*16 



HL=.dpb 



; sector 
Ixi 
mov 
ret 



number in 
h, sector 
m,c 



sectran: 



;translate sector EC using table at DE 

xchg ;HL = .tran 

dad b ;single precision tran 
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48. 




dad b again 


49 




mov 1,111 


50, 




fill both H 


51: 




ret 


52; 






53i 


• sector: 


ds 1 


54; 




endef 


55; 




end 



if double precision tran 

;onlY low byte necessary here 
and L if double precision tran 

;HL = ??SS 



Referring to the program shown above, lines 3-6 represent the 
BIOS entry vector of 17 elements (version 1.4 defines only 15 jump 
vector elements) . The last two elements provide access to the 
"LISTST" (List Status) entry point for DESPOOL. The use of this 
particular entry point is defined in the DESPOOL documentation, and is 
no different than the previous 1.4 release. It should be noted that 
tne 1.4 DESPOOL orogram will not operate under version 2.0, but an 
update version will be available from Digital Research in the near 
future. 

The "SECTRAN" (Sector Number Translate) entry shown in the jump 
vector at line 6 provides access to a BIOS-resident sector translation 
subroutine. This mechanism allows the user to specify the sector skew 
factor and translation for a particular disk system, and is described 
below. 

A macro library is shown in the listing, called DISKDEF, 
included on line 2, and referenced in 12-15. Although it is not 
necessary to use the macro liorary, it greatly simplifies the disk 
definition process. You must have access to the MAC macro assembler, 
of course, to use the DISKDEF facility, while the macro library is 
included with all CP/M 2.0 distribution disks. (See the CP/M 2.0 
Alteration Guide for formulas which you can use to hand-code the 
tables produced by the DISKDEF library) . 



A BIOS disk definition consists of 
macro statements: 



the following sequence of 



MACLIB 


DISKDEF 


DISKS* 


n 


DISKDEF 


0,... 


DISKDEF 


-1- r • • • 


DISKDEF 


n-l 



ENDEF 



file (on the same 
The DISKS macro call 
be configured with 



where the MACLIB statement loads the DISKDEF. LIB 

disk as your BIOS) into MAC's internal tables. 

follows, which specifies the number of drives to 

your system, where n is an integer in the range 1 to 16. A series of 

DISKDEF macro calls then follow which define the characteristics of 

each logical disk, through n-l (corresponding to logical drives A 

through P) . Note that the DISKS and DISKDEF macros generate in-line 
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fixed data tables, and thus must be placed in a non-executable portion 
of your BIOS, typically directly following the BIOS jump vector. 

The remaining portion of your BIOS is defined following the 
DISKDEF macros, with the ENDEF macro call immediately preceding the 
END statement. The ENDEF (End of Diskdef) macro generates the 
necessary uninitialized RAM areas which are located above your BIOS. 

The form of the DISKDEF macro call is 

DISKDEF dn,fsc,lsc, [skf] , bis , dks ,dir ,cks , of s, [0] 

where 

dn is the logical disk number, to n-1 

fsc is the first physical sector number (0 or 1) 

Isc is the last sector number 

skf is the optional sector skew factor 

bis is the data allocation block size 

dir is the number of directory entries 

cks is the number of "checked" directory entries 

ofs is the track offset to logical track 00 

[0] is an optional 1.4 compatibility flag 

The value "dn" is the drive number being defined with this DISKDEF 
macro invocation. The "fsc" parameter accounts for differing sector 
numbering systems, and is usually or 1. The "Isc" is the last 
numbered sector on a track. When present, the "skf" parameter defines 
the sector skew factor which is used to create a sector translation 
table according to the skew. If the number of sectors is less than 
256, a single-byte table is created, otherwise each translation table 
element occupies two bytes. No translation table is created if the 
skf parameter is omitted (or equal to 0) . The "bis" parameter 
specifies the number of bytes allocated to each data block, and takes 
on the values 1024, 2048, 4096, 8192, or 16384. Generally, 
performance increases with larger data block sizes since there are 
fewer directory references and logically connected data records are 
physically close on the disk. Further, each directory entry addresses 
more data and the BIOS-resident ram space is reduced. The "dks" 
specifies the total disk size in "bis" units. That is, if the bis = 
2048 and dks = 1000, then the total disk capacity is 2,048,000 bytes. 
If dks is greater than 255, then the block size parameter bis must be 
greater than 1024. The value of "dir" is the total number of 
directory entries which may exceed 255, if desired. The "cks" 
parameter determines the number of directory items to check on each 
directory scan, and is used internally to detect changed disks during 
system operation, where an intervening cold or warm start has not 
occurred (when this situation is detected, CP/M automatically marks 
the disk read/only so that data is not subsequently destroyed) . 
Normally the value of cks = dir when the media is easily changed, as 
is the case with a floppy disk subsystem. If the disk is permanently 
mounted, then the value of cks is typically 0, since the probability 
of changing disks without a restart is quite low. The "ofs" value 
determines the number of tracks to skip when this particular drive is 
addressed, which can be used to reserve additional operating system 
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space or to simulate several logical drives on a single large capacity 
physical drive. Finally, the [0] parameter is included when file 
compatibility is required with versions of 1.4 which have been 
modified for higher density disks. This parameter ensures that only 
16K is allocated for each directory record, as was the case for 
previous versions. Normally, this parameter is not included. 

For convenience and economy of table space, the special form 

DISKDEF i,j 

gives disk i the same characteristics as a previously defined drive j. 
A standard four-drive single density system, which is compatible with 
version 1.4, is defined using the following macro invocations: 

DISKS 4 
DISKDEF 0,1,26,6,10 24,243,64,64,2 
DISKDEF 1,0 
DISKDEF 2,0 
DISKDEF 3,0 

.... 
ENDEF 

with all disks having the same parameter values of 26 sectors per 
track (numbered 1 through 2*6) , with 6 sectors skipped between each 
access, 1024 bytes per data block, 243 data blocks for a total of 243k 
byte disk capacity, 64 checked directory entries, and two operating 
system tracks. 

The definitions given in the program shown above (lines 12 
through 15) provide access to the largest disks addressable by CP/M 
2.0. All disks have identical parameters, except that drives and 2 
skip three sectors on every data access, while disks 1 and 3 access 
each sector in sequence as the disk revolves (there may, however, be a 
transparent hardware skew factor on these drives) . 

The DISKS macro generates n '*disk header blocks," starting at 
address DPBASE which is a label generated by the macro. Each disk 
header block contains sixteen bytes, and correspond, in sequence, to 
each of the defined drives. In the four drive standard system, for 
example, the DISKS macro generates a table of the form: 

$ 

XLT0,0000H,0 00H,0000H,DIRBUF,DP30,CSV0,ALV0 
XLT0,0000H,0 00H,00 00H,DIRBUF,DPB0,CSV1,ALV1 
XLT0,0 000H,0 00H,0 00H,DIRBUF,DPB0,CSV2,ALV2 
XLT0,00 00H,0 00H,0 000H,DIRBUF,DPB0,CSV3,ALV3 

where the DPE (disk parameter entry) labels are included for reference 
purposes to show the beginning table addresses for each drive 
through 3. The values contained within the disk parameter header are 
described in detail in the CP/M 2.0 Alteration Guide, but basically 
address the translation vector for the drive (all reference XLT0 , 
which is the translation vector for drive in the above example) , 

(All Information Contained Herein is Proprietary to Digital Research.) 

31 



DPBASE 


EQU 


DPE0; 




DW 


DPEl; 




DW 


DPE2: 




DW 


DPE3: 




DW 



followed by three 16-bit "scratch" addresses, followed by the 
directory buffer address, disk parameter block address, check vector 
address, and allocation vector address. The check and allocation 
vector addresses are generated by the ENDEF macro in the ram area 
following the BIOS code and tables. 

The SELDSK function is extended somewhat in version 2.0. In 
particular, the selected disk number is passed to the BIOS in register 
C, as before, and the SELDSK subroutine performs the appropriate 
software or hardware actions to select the disk. Version 2.0, 
however, also requires the SELDSK subroutine to return the address of 
the selected disk parameter header (DPE0, DPEl , DPE2, or DPE3, in the 
above example) in register HL. If SELDSK returns the value HL = 
0000H, then the BDOS assumes the disk does not exist, and prints a 
select error mesage at the terminal. Program lines 22 through 36 give 
a sample CP/M 2.0 SELDSK subroutine, showing only the disk parameter 
header address calculation. 

The subroutine SECTRAN is also included in version 2.0 which 
performs the actual logical to physical sector translation. In 
earlier versions of CP/M, the sector translation process was a part of 
the BDOS, and set to skip six sectors between eacn read. Due 
differing rotational speeds of various disks, the translation function 
has become a part of the BIOS in version 2,0. Thus, the BDOS sends 
sequential sector numbers to SECTRAN, starting at sector number 0. 
The SECTRAN subroutine uses the sequential sector number to produce a 
translated sector number which is returned to the BDOS. The BDOS 
subsequently sends the translated sector number to SELSEC before the 
actual read or write is performed. Note that many controllers have 
the capability to record the sector skew on the disk itself, and thus 
there is no translation necessary. In this case, the "skf" parameter 
is omitted in the macro call, and SECTRAN simply returns the same 
value which it receives. The table shown below, for example, is 
constructed when the standard skew factor skf = 6 is specified in the 
DISKDEF macro call: 

XLT0: DB 1,7,13,19,25,5,11,17,23,3,9,15,21 
DB 2,8,14,20,26,6,12,18,24,4,10,16,22 

If SECTRAN is required to translate a sector, then the following 
process takes place. The sector to translate is received in register 
pair BC, Only the C register is significant if the sector value does 
not exceed 255 (B = 00 in this case) . Register pair DE addresses the 
sector translate table for this drive, determined by a previous call 
on SELDSK, corresponding to the first element of a disk parameter 
header (XLT0 in the case shown above). The SECTRAN subroutine then 
fetches the translated sector number by adding the input sector number 
to the base of the translate taole, to get the indexed translate table 
address (see lines 46, 47, and 48 in the above program). The value at 
this location is then returned in register L. Note that if the number 
of sectors exceeds 255, the translate table contains 16-bit elements 
whose value must be returned in HL. 

Following the ENDEF macro call, a number of uninitialized data 
areas are defined. These data areas need not be a part of the BIOS 
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which is loaded upon cold start, but must be available between the 
BIOS and the end of memory. The size of the uninitialized RAM area is 
determined by EQU statements generated by the ENDEF macro. For a 
standard four-drive system, the ENDEF macro might produce 

4C7 2 = BEGDAT EQU $ 
(data areas) 
4DB0 = ENDDAT EQU $ 
013C = DATSIZ EQU $-BEGDAT 

which indicates that uninitialized RAM begins at location 4C72H, ends 
at 4DB0H-1, and occupies 013CH bytes. You must ensure that these 
addresses are free for use after the system is loaded. 

CP/M 2.0 is also easily adapated to disk subsystems whose sector 
size is a multiple of 128 bytes. Information is provided by the BDOS 
on sector write operations which eliminates the need for pre-read 
operations, thus allowing blocking and deblocking to take place at the 
BIOS level. 

See the "CP/M 2.0 Alteration Guide" for additional details 
concerning tailoring your CP/M system to your particular hardware. 
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